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As knowledge of the internal workings of player/missile graphics is not 
necessary to use this valFORTH package effectively, the internal workings are 
not explained -in ho rm rial; However , far the serious programmer trying to 
optimize his/hot p n- at in wary a;-. • understanding of these internal 

efficiency and/or speed of execution. 

For a complete expire' .tic n of r-layer/missile graphics at the nut-and-bolt level, 
see the v • -s w rp l f by - fn 11 in Creative Computing. 
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STROLLING TifOUGH PLAYER/MISSILE GRAPHICS 


betweer the Atari graphic capabilities and 
those of most other conipt ere :he Atari 1 s ability to use players and missiles. 
This discussion wiT ^ot explain the internal workings of player/missile graphics 
on the Atari; rather, it will explain how to use the basic commands in this 
val FORTH package. Before we proceed please load the player/missile graphic 
routines from the Player/Mis si le disk. The directory on screen 170 will show 
what screen t fa ■ the val FORTH Editor/Utilities package, 

load in the -high pee STI command found in the Miscellaneous Utilities; 
otherwise, loaf in tf slower version o your Player/Missile disk. (Check the 
directory for its location). 

To start with, : >• e '-nr le layer up on the screen to experiment with. 

First we must initialize the pltyer/miss le graphic system and design the player's 
image. This is simple 


1 PM I NIT 




( Change to binary for ease ) 

( ff the player image a name ) 


2 BASE S 


00011000 C, 
00011000 C, 

00011000 c. 


( A large plus sign ) 


( Now back into base 10 ) 
i Cl ea r pi ayer/missile memory ) 
( Turn on the players ) 












You should now see se cross in the upper right-hand corner of the video screen. 
Now let's take a look at this and see how it works. 

First, players are initi-.l irtd us ing the PMINIT command. Players can be in 
either a single or double resolution mode (double res players are twice as tall). 
"1 PMINIT" is used for single es piavers. If we had wanted double res players, 
we would have used “2 PMINIT" 

Next, the player imago is created. Since it is much easier to make player 
images as l's and 0's, we use binary (base two) number entry. Before we design 
the image, it must be given a name. The LABEL command does this nicely for us. 
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This image is named CROSS. All that need be done now is to draw the picture. 
Notice how easy it is to see the image when using base two. Of course, we could 
have stayed in base 10 and still designed the image, but this is usually more 
difficult. The word C, after each number simply tel Is FORTH to store that number 
in the dictionary. Once the picture is designed, we return to decimal for ease. 

Both the PMCLR and ON PLAYERS commands are fairly self-descriptive: PMCLR 
erases al1 players and missiles so that no random trash appears when the PLAYERS 
are turned ON. Next, the BLDPLY (build player) command takes the image named 
CROSS which is 8 bytes tall and assigns it to player 0 at horizontal location 180 
and vertical location 50 on the display. Of course, we could have built player 
1, 2, or 3 instead. 

The cross should be black. Suppose we wanted a blue or green cross instead. 
This can be done using the PMCOL (player/missile color) command. Try this: 

( player hue lum PMCOL ) 

The cross should now appear blue. This command assigns a BLUE (9) hue with a 
1uminance of 8 to player 0. If the color commands are loaded from the valFORTH 
disk. 


0 BLUE 8 PMCOL 

could have been used with the same results. Try changing the color of the player 
to GREEN (12) or PINK (4). Note that the default colors for players 2 and 3 make 
them invisible: Their colors should be set immediately upon being built. 

Now that we have a piayer on the screen, let's move it around. We use the 
PLYMV (player move) command for this. PLYMV needs to know which player to move 
(there could be as many as five), how far to move it in the horizontal direction, 
and how far to move it in the vertical direction. Try this: 


1 

1 

0 

PLYMV 


This moves 

player 0 down 

1 line and right one horizontal position, thus giving the 

effect 

of 

a di 

agonal move 

towards the lower right-hand corner. Try these as well: 



0 

PLYMV 

( move right one position ) 

-5 

0 

0 

PLYMV 

( move left five positions ) 

0 

20 

0 

PLYMV 

( move down 20 lines ) 

0 - 

-15 

0 

PLYMV 

( move up 15 1 i nes ) 

-5 

2 

0 

PLYMV 

( move left five, and down two ) 


That's all there is to moving a player. Positive horizontal offsets move the 
piayer right, and negative values move the player left. Likewise, positive 
vertical offsets move the player down while negative ones move the player up. 
The following program can be typed in and you will have a joystick controlled 
player: 







Move the player with stick 0, the 1eft-most stick port. Press any console button 
to exit the program. 

on the topand 200 on the bottom V : ,oe JOY again to verify that you can no 
longer move freely about the .display.. Try different boundary settings and 

boundary will do the same. 

from the standard Atari character • stored in ROM, the image of the digit 

■ 




. 
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Type JOY again and notice that the width has no effect on movement whatsoever. 
Also notice that player one is unaffected by movement of player zero. 

Now that we have two players on the screen, let's interface both of them 
to the joystick. Type in the following program: 


: JQY2 
BEGIN 


Rotate stick 90 degrees } 
Move piayer 1 ) 


0 STICK 
20UP 

0 PLYMV 
SWAP 

1 PLYMV 
’TERMINAL 
UNTIL ; 


J0Y2 <ret> 

Notice that when you push the stick up, player zero goes up, but player one 
moves left. The SWAP instruction exchanges the vertical and horizontal offsets 
from STICK before moving player one. If we were to take the SWAP out, the 
players would move identically. 

In many applications, it is necessary-to know when a player has hit another 
player or some background image. 

makes this information available. An entire collection of valFORTH words allows 
returns a true flag if anything has hit anything else. Here is an example: 


: BUMP 


BEGIN 

0 STICK 
0 PLYMV 

IF 



UNTIL ; 

Move the piayer around and watch the results. 

or player one, the 'word oops! ! should be printed out. This program is quite 
simple. First, the HITCLR command is issued which erases any old collision 
information. If this command were omitted, the first time a collision occurred, 
"oops 1" would be continuously printed out. Next the joystick is read and the 
player moved. If the player touches anything when moved, the collision 

player has hit something, and the IF statement will then print out "oops!”. 
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player/missile example programs can be found on your Player/Misslie disk. 
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PLAY E R/ MIS SHE GLOS SARY 


Enabling Player-Missile Graphics 

To make use of players and missiles, the video processor must be activated. 
Players can be several sizes, they can have different overlap priority schemes, 
and they can have different colors. The following collection of "words" makes 
this setup task quite simple. Note: Players and missiles are numbered 0 through 
3. The fifth player is numbered as four. 


(PMINIT) ( addr res — ) 

The (PMINIT) command (or PMINIT below) must be used to initialize 
the player missile routines before any other piayer missile command may 
be used. (PMINIT) expects both the address of player/missile memory 
and a 1 or a 2 indicating whether single or double resolution is desired. 


NOTE: The difference between single and double resolution is shown 
graphically below: 


PIayer as defined 


double res 

in memory: 


on screen: 

00011000 


@8 

00111100 


09 

01111110 

@@@@69 

®6©C5 

00111100 

©@e@ 


00011000 


tooooa 

906900 

csea 

0080 

90 





PMINIT 


res — ) 


The PMINIT command functions identically to the (PMINIT) command 
above, except that no address need be given. PMINIT calculates an address 
based on the current graphic mode. It uses the first unused 2K block of 
memory below the highest free memory (*i.e.» below the display list). 

This should only be used while first learning the system, after that, 
(PMINIT) should be used to optimize memory uti1ization. Note that the 
variable PMBAS contains the calculated address upon return. 


PMBAS 


addr ) 


A variable containing the address of player/missile memory. This 
value must lie on a 2K boundary if single resolution players are used 
and on a IK boundary if double resolution players are used. This is set 
using the (PMINIT) command and is automatically set by the PMINIT command 
described above. This value should never be set directiy, but can be 
read at any time. 
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PMCLR 

This command clears all players and all missiles. This is generally 
used just prior 'to activating the pi aye -missile graphic mode to ensure 
that no random trash is placed on the video screen. PMCLR expects no 
values on the stack, nor does it leave any. 


MCPLY 

The MCPLY (Multi-Color Player) command expects one value on the top 
of the stack. If this value is 0 or OF;, then the multi-color player mode 
is disabled. If this value is 1 or ON, this command instructs the video 
processor to logically "or" the bits of the colors of player zero with 
player one, and also of player two with player three. In other words, 
when players 0 and 1 overlap (or player*! 2 and 3), a third color (determined 
by the colors of the overlapping players) will be assigned to the overlapped 
region rather than assigning one of the players a higher priority. Since 
players must be one color, this allows for multi-colored players. For 
example: 




MCPlayer 

Pink color 


Pink/blue 








BBBBBBBB 

BBBBBBBB 

pppppppp 



PPPPPPPP 



PPPPPPPP 


pppppppp 

PP PP 








are also OR'd. 


whether the plane will pass behind the building. Objects with higher 


















PL2 






PLO 




















* PF3 and PL4 share the same priority 


Objects higher on the list will appear to pass in front of objects 
lower on the list. 
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Once the pi ayer/missile graphics system has been activated and the 

Normally, this would be quite difficult to do; however, using the commands and 
designing techniques described below, this task is made very simple. 

There are really only three things to do in the creation of a player: setting 
the width size, setting the color, and creating the picture. 


PLYWID 


( width pi# — ) 


The PLYWID command sets the specified player to the desired width. 
■ 

Legal widths are: 


image: 10111101 

0 = normal width: 

1 = double width: m ea 

2 = normal width: 

3 = quad, width: l try.* : ;-r<?eeeertaa 

Any other value may cause strange results. 

MSLWID 


8 9118! ft 


size ml# — ) 


The MSLWID command is identical to the PLYWID command described above 
except that it is used to set the size of the missiles. The same size 
values apply also. The MSLWID command should only be used when in the 
missile mode (i.e., with the fifth player deactivated). 

PMCOL ( pi# hue lum - 

To set the color (hue and lum) of a player, the PMCOL (Player- 
Missile-Color) command is used. It sets the specified player to the hue 

, 

the colors of missiles as missiles take on the colors of their respective 
players. To set the color of the 5th player, “pi#" should be 4. If the 
color words on the valFORTH 1.1 disk are loaded, they can be used to set 
piayer colors: 




This sets player #0 to a medium blue color. 







The player is then ready to be moved about the screen using 

the PLYMV owmwnd described below, 

of. Practice has proven that the following method is easiest for creating 

■ 

PICTURE S , 40 0 BLDEhV 
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PUTTING PLAYERS AND MISSILES IN THEIR PLACE 


Generally, once a player or missile has been created and put to the video 
screen, it is moved around. This can be accomplished very easily with the next 
set of words. Interfacing a movable player with the joystick can improve just 
about any program which requires input. As a result, it usually gives the 
program a more professional appearance. 

horz vert ) 

The PLYLOC command (PLaYer LOCation) returns the vertical and 
horizontal positions of the specified player. This is normally used 
when a joystick/button setup is being utilized - - i. e., when a joystick 
is moving a player and the button is used to pinpoint where the player 
is. A program which draws lines between two dots could use this. The 

Pressing the button tells the program that a selected spot has been made. 
Once a second spot has been selected, the program then draws a line 
between them. 

MSLLOC (ml# — horz vert ) 

The MSLLOC command performs the same function as the PLYLOC command 
described above except that it is used to find locations of missiles 
instead of players. Note that using MSLLOC on a fifth player gives 
meaningless results. 


PLYMV 


horz vert pi# — ) 


The PLaYer MoVe command moves the specified player the direction 
specified by "vert" and "horz". If "vert" or "horz" is negative, the 
player is moved up or left respectively, otherwise it is moved down or 
right unless they happen to be zero in which case nothing happens. The 
following examples clarify this; 


0-50 PLYMV 
-1-1 3 PLYMV 
3-1 2 PLYMV 


( Move piayer 2 up one dot and right 3 ) 


MSLMV 


horz vert ml# 


' 

above except that it is used to move missile about the video screen. 


PLYPUT 




The PLYPUT command positions player "pi#" to the location (horz,vert) 
on the video screen. 





The PLYSEL command is used to select image out of a table of 
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It is often desirable to put limitations on the movements of players 
and missiles. Boundaries can be set up for each player and missile independently 
and upon each move command, they will remain within" those boundaries. Additionally, 
a boundary status byte for each player is available for scrutiny at any time. 

This section explains how this is.used. 

In most applications, the movements of players are kept within certain 
boundaries. The PLYBND command frees the user from having to worry about 
boundary checking. This command expects the player number and all four 
boundaries. Whenever a PL 'MV is then used, the player is always kept 
within the set boundaries. Also, upon each move a boundary status byte 
is left in the c-array PLL'STT (see'TPLYSTT below). The edge boundaries of 
the screen are; 




resolutions 




223 for single, 111 for double 


Note that in special cases the boundary checker will fail. If the 
left boundary is 0 and the player is at the boundary, any move left will 
not be checked as expected. For example, if it were moved left by one 

Since only 8 bit unsigned comparisons are made, the horizontal position 

alculoting boundary checking turns 

out to be more useful b* aus; 

If an unbounded player i: -.e ire - u 




on screen 170 of your disk. 


MSLBND 




that it is used for missiles. Upon each move a boundary status byte is 
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?BND 3 AND 


Given a missile number, returns the boundary check byte of that missile. 
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CHECKING FOR INTERACTION BETWEEN PLAYERS 


desired. But once that player is on the screen and moving around, it is often 

touch or “crash'' into, each other. This remaining collection of commands allows 
checking of al1 possible "hit" combinations. 



?C0L 


( ... f } 


The ?C0L command is a very general collision detector. It does nothing 
more than indicate whether two or more objects have "crashed" -- it does not 
give any indication of what has collided. It leaves a 1 on the stack if a 


?MXPF 




1 he ?MXPF command is a much more specific collision detection command. 
It stands for "Tcoltision of Missile #X with any PlayField". It is used 
to check if a specific missile has hit any playfield. It returns a zero 

















0011 






010-1 









1000 








11 




1100 













To test for a col 1isi on with one specific playfield, use one of the 


1 AND 


Leaves 





el se 

0 ) 

2 AND 






pf#l, 



4 AND 






pf#2. 



8 AND 




n 
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Player/Missile Command Summary 


(PMINIT) 

( addr res — 


PMINIT 



PMBAS 







( ON/OFF ... ) 


PMCLR 

MCPLY 

( ml« — } 


PRIOR 






MSLWIQ' 

( width ml# — 



( pi# hue lum ■ 




vert 


( addr len horz 

vert 





( ml? horz 

vert 


( horz vert pi# 


MSLMV 

( horz vert ml# 









( addr = pi# -- 



{ i r t b pi * 























7MXPL 










PM memory specified by addr" with '“res" 
resolution. 

Initializes the player missile routines with 
at the first available memory below the 

This'command turns (tne fifth player mode) 

ON or OFF. If OFF, missiles take the colors 
of their corresponding players. If ON, ail 
missiles take on the common color of play- 
field 3. The fifth player is numbered as 

Erases the specified player (0-3,4). 

Erases the specified missile (0-31. 

riayer "©del ON or OFF. See documentation 
for e>p : anation. 

Sets the priority of .players and playfields. 
See x documentation for legal settings. 

Sets the width of the specified player. 

Legal widths are normal (0 or 2), double (1), 
or quadruple 13). 

Creates a player whose ^mage is at "addr" 

nates of the specified player. 

Moves the specified player according to the 
horizontal and vertical offsets specifies 

a positive vertical offset moves tne player 

horizontal and vertical offsets specified. 
Positions the specified player and location 

player to the image of length 'en" at addr ,; . 
T his changes the image of the specified 
player to image number - • in ,> table of 

Specified the left, right, top, and bottom 
boundaries of the specified player. 

of the specified plays'. See documentation 
for a description o' ‘his value. 

‘or a description of this va me. 

If any collisions have occurred, a status 
. 

• th- ‘roci f i :■ * nis:. ; ' c ’’ as rot 

value is returned. See documentation. 

Returns 0 if the specified player has not 
hit ao i other player- since’ the last hITCLR 
command. If any collisions have occurred, a 
status value 1 - returned. 

Clears the coll; ion registers to a no^ 


Audio Editor Command Summary 

Calls up the audio-palette program. 

Character Editor Command Summary 

Calls up the character editor. 


?Li)V£}l-«J]331i!£ BOUNDARY MAP 

valFORTH 


(Double resolution values are in parentheses) 




32 = $20 
(16) 



32 

(16) 


48- 


Video Screen 


t ■ ’J' 


223 = $DF 
(111 = $6F) 


-207 = $CF 
(Right) 


-207 


223 
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S'yj'jia-a.imaig Memory Map 

v£sIFC!!7¥k$ u 



SINGLE RESOLUTION 

PMBASE+ 2048 

PMBASE + 1792 

PMBASE + 1536 

PMBASE + 1280 

PMBASE + 1024 

PMBASE + 768 


PMBASE 
(Must lie on a 
2K boundary) 


8 bits 


Player 3 


Player 2 


Player 1 


Player 0 


Missiles* 
(5th Player) 


Unused Memory 

Available to User 


DOUBLE RESOLUTION 

PMBASE + 1024 

-PMBASE + 896 

-PMBASE + 768 

-PMBASE + 640 

-PMBASE + 512 

-PMBASE + 384 


PMBASE 
(Must lie on a 
IK boundary) 





*Note: All nvissi'es occupy the same memory location. 

This is possible because unlike players which 
are 8 bits wid-. and fill an entire.byte, mis¬ 
siles are only two bits wide. Four missiles 
can therefore be represented in the same amount 
of memory as a single player. 

Byte form: > m3 I m2 ! ml ; mO ■ 
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QBREK 
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A variable .cntavn'i r.g the, numb - > the - ext 
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a large 1 by 8 byte array. In some of these modes, the highest one or 


















































































































































































Two bitsypixel, 4 pixels/byte 
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